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INTRODUCTION 

For  measuring  code  snippets  on  a  windows  machine  with  C++,  it’s  convenient  to  use  the 
built-in,  high-resolution  timestamps.  For  native  code,  the  function  QueryPerformanceCounter  is 
available  to  retrieve  this  timestamp.  There  are  other  versions  of  this  function  for  managed  and 
kernel-mode  code,  but  for  the  purposes  of  this  discussion,  the  report  will  concentrate  on  native  code. 


METHODOLOGY 

In  order  to  access  this  Application  Program  Interface  (API),  the  coder  is  only  required  to 
include  windows. h.  The  usage  of  this  API  can  be  easily  understood  from  the  following  snippet  of 
code  taken  from  the  Microsoft  Developer  Network  (MSDN). 

LARGE_INTEGER  Star tingTime ,  EndingTime,  ElapsedMicroseconds; 

LARGE_INTEGER  Frequency; 

QueryPer formanceFrequency ( SFrequency) ; 

QueryPerformanceCounter ( &StartingTime)  ; 

//  Activity  to  be  timed 

QueryPerformanceCounter ( &EndingTime) ; 

ElapsedMicroseconds . QuadPart  =  EndingTime . QuadPart  -  StartingTime .QuadPart; 


// 

//We  now  have  the  elapsed  number  of  ticks,  along  with  the 
//  number  of  ticks-per-second.  We  use  these  values 
//  to  convert  to  the  number  of  elapsed  microseconds. 

//  To  guard  against  loss-of-precision,  we  convert 

//  to  microseconds  *before*  dividing  by  ticks-per-second. 

// 

ElapsedMicroseconds . QuadPart  *=  1000000; 

ElapsedMicroseconds . QuadPart  /=  Frequency. QuadPart; 

QueryPerformanceFrequency  must  be  called  in  order  to  get  the  performance-counter 
frequency.  The  frequency  is  returned  in  counts/ticks  per  second.  This  frequency  does  not  change, 
so  this  function  only  needs  to  be  called  once.  As  the  previous  code  shows,  a  timestamp  is  retrieved 
by  calling  QueryPerformanceCounter  before  and  after  the  code  to  be  measured. 

Depending  on  the  units  desired,  the  value  of  the  number  of  ticks  is  then  multiplied  by  the 
appropriate  value  (10A6  for  ps,  10A3  for  ms,  etc.).  The  previous  example  is  1000000  in  order  to  get 
the  value  in  ps.  The  result  is  then  divided  by  the  number  of  ticks  per  second. 

As  a  simple  example  of  this,  consider  the  following  program: 
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int  _tmain(int  argc,  _TCHAR*  argv[]) 

{ 

LARGEJNTEGER  frequency; 
QueryPerformanceFrequency(&frequency); 

LARGEJNTEGER  starting_time,  ending_time,  elapsed_microseconds; 
QueryPerformanceCounter(&starting_time); 


//put  code  to  measure  speed  of  here!!! 

Sleep(lOO); 

QueryPerformanceCounter(&ending_time); 

elapsed_microseconds.QuadPart  =  ending_time.QuadPart  -  starting_time.QuadPart; 

//this  time  is  in  micro  seconds 

auto  time_elapsed  =  static_cast<double>((elapsed_microseconds.QuadPart  *  1000000.0)  /  frequency.QuadPart); 
printf("Time  Elapsed:  %4.2f\n",  time_elapsed); 
printf("AII  done!\n"); 
getcharf); 

return  0; 

} 


All  this  program  is  going  to  do  is  measure  a  Sleep(IOO).  Keep  in  mind  that  Windows  is  not 
considered  a  real  time  operating  system  and  does  not  guarantee  times  like  the  amount  of  time  a 
program  is  told  to  sleep.  But  as  one  can  see  by  the  output  produced  in  figure  1 ,  it  is  pretty  close. 


Figure  1 
Output 

The  program  was  told  to  sleep  100  ms  and  99.898  ms  was  measured. 
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CONCLUSIONS 

Speed  measuring  in  a  C++  Windows  environment  is  a  relatively  easy  way  for  a  programmer 
to  gauge  the  relative  efficiency  of  two  comparable  sets  of  code.  Using  the  performance-counters 
provided  in  the  Windows  Application  Program  Interface,  the  coder  can  quickly  find  performance 
bottlenecks,  measure  the  impact  that  a  new  piece  of  code  will  have  on  an  existing  code  base,  or 
compare  the  efficiency  difference  between  two  code  snippets. 
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